home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Libris Britannia 4
/
science library(b).zip
/
science library(b)
/
COMMUNIC
/
COMMUTIL
/
2258.ZIP
/
EZMESS35.ZIP
/
EAZMESS3.DOC
< prev
next >
Wrap
Text File
|
1990-05-15
|
34KB
|
798 lines
EAZMESS3.EXE V3.56 - EaziLink V3 Host/EaziHost V1 Message Editor
---------------------------------------------------------
15th May 1990
Disclaimer
----------
This program is being put into the Public Domain and may be freely
distributed on the understanding that no responsibility can be
accepted for any problems arising from its use. To the best of our
knowledge, it is 'Bug free' and serves its intended purpose.
No charge, other than a nominal charge for duplication and postage may
be made for it and it should only be supplied as a single ARC, ZIP or
PAK file called EZMESS35.ARC, EZMESS35.ZIP or EZMESS35.PAK, containing
the EAZMESS3.EXE, EAZMESS3.CNF and EAZMESS3.DOC files.
This version may be used with either EaziLink V3, or EaziHost V1. In
the case of EaziHost, it can be used with up to 64 message areas.
Overview
--------
EAZMESS3 provides facilities to edit and answer messages created by
EaziHost V1 or by EaziLink V3 Host Mode without having to load
EaziLink or EaziHost. The 'Private' and 'Received' status of messages,
the Subject, the names of the person who posted the message and the
person it is for, may all be changed in addition to the ability to
'Kill', 'Copy', 'Edit', 'Answer' and 'Junk' mail messages. In
addition, facilities are provided to delete all messages up to and
including a specified date, or Received Private messages before a
specified date (See Command Line Parameters). User Validation levels
may also be changed and names added to Member Lists (EaziHost only).
NOTE FOR USERS OF EARLIER VERSIONS
----------------------------------
This section describes the main changes for the benefit of users of
earlier versions and people changing over to EaziHost.
1. The EAZMESS3.CNF file is now REQUIRED.
2. Changes have been made to the layout of the CNF file. Entries may
now be in any order and are preceded by a line identifier. This is
more in line with EaziLink/EaziHost configuration files. Note also
that the Sysop entry is now REQUIRED, as also is a new VERSION
parameter.
3. Multiple file areas are now supported when used with EaziHost. The
program checks for the validity of names entered, both with regard to
whether the user is validated for that area and, if being used,
whether the name is included in the Member List for the area.
4. A new '(I)ncl' option has been provided for EaziHost users, to
allow names to be added to Member Lists.
5. The '(C)opy' option has been replaced with an enhanced (=) command.
This copies the current message, after asking for the name of the
intended recipient, to a new message, preceding the text of the
message with a line containing 'COPY OF MESSAGE TO :' followed by the
name of the original recipient of the message.
6. A new '(C)lr' option has been added to simplify the clearing of
filters.
7. When Answering an existing message, the Sysop's name is now
automatically inserted as the sender. Similarly, when '(M)ake' is used
to create a new message.
8. Up to 64 Message Areas are now supported.
9. When initially running, the check for 'New Messages' skips over
areas containing no new messages, so that new messages are displayed
without the need to manually confirm you wish to change to a new area.
The option to Quit is now offered when all new messages have been
read. Selecting 'N' selects the first message area in 'full' edit
mode.
10. The Left and Right Cursor keys may be used to move backwards and
forwards through messages, in addition to the 'B' and 'N' keys. The
'Home' and 'End' keys may be used to go directly to the oldest and
most recent messages in an Area when in full edit mode.
11. A further, optional, command line parameter has been added. An
Area Number may be passed as a parameter, in which case EazMess3 will
go straight to that area in 'full edit mode' and the first message
will be displayed. If no messages exist a request whether a new
message is to be created is issued.
Apart from these changes, most existing functions work as before, but
in a few cases minor changes have been made, particularly with regards
to checking the validity of users.
Using EAZMESS3
--------------
EAZMESS3.EXE and EAZMESS3.CNF should be located in a directory
specified in the MS-DOS PATH. See the section headed 'Configuring
EAZMESS3' for details of configuring EAZMESS3.CNF.
EAZMESS3 also requires access to a text editor if any message text is
to be changed, or messages are to be replied to or created. Almost any
text editor may be used, as long as it will accept a filename being
passed to it as a command line parameter. EAZIEDIT, which is supplied
to registered users of EaziLink is ideal. See 'Configuring EAZMESS3'
for details of using your own editor.
If EazMess3 is installed correctly, typing 'EAZMESS3' and pressing
Return will load the program from any directory. EAZMESS3 will load
and display the first unread message addressed to the Sysop, in a
similar layout to that of EaziLink's Host mode and EaziHost. In the
case of use with multiple file areas in EaziHost, any directory
specified in EaziHost as the directory to which all log-off messages
are to be posted will be selected first.
Note: New messages to 'ALL' are NOT treated as new messages for this
purpose, as messages to 'ALL' are always marked 'unread' by
EaziLink/EaziHost and would otherwise appear every time EazMess3 was
used.
If there are any new messages, only a limited range of editing and
movement commands are available, but once all new messages have been
viewed, answered or killed the option to Quit is offered. If this is
not chosen, the full editing mode becomes available and the first
message in the first message area selected. See Command Line
Parameters for details of over-riding the 'New Message only' setting.
In the case of Multiple EaziHost file areas, you are offered the
option to change areas or continue editing the current area. Pressing
Return will select the next area, or entering a valid area number will
select that area instead. Pressing 'Q' from this prompt will exit the
program completely.
At the bottom of the screen are two lines of available commands:-
Edit:
(K)ill
(A)ns
(E)dit
(R)ead
(V)ali
(I)ncl - Only when used with EaziHost
Move:
(N)ext
(B)ack
(Q)uit
Once all new messages have been seen, the following menu options are
available (if you specify that you do not want to Quit).
Edit:
(K)ill
(M)ake
(A)ns
(E)dit
(R)ead
(S)ubj
(F)rom
(T)o
(V)ali
(I)ncl - Only when used with EaziHost
(P)riv
Move:
(N)ext
(B)ack
(G)oto
(J)unk
(O)rig
(D)est
(H)ead
(+)
(-)
(=)
(C)lr
(Q)uit
The upper line contains commands to alter messages, whilst the lower
line provides commands to move through and search for messages.
Selection is by pressing the first letter of each command.
When used with EaziHost, the Current Message Area Name is displayed at
the bottom of the screen and the Area number in the message header, as
it is when using EaziHost.
Description of Commands
-----------------------
NOTE: Only those commands marked with an asterisk '*' are available
when viewing new messages.
(K)ill *
Kill serves the same purpose as in EaziLink Host mode or EaziHost and
removes the message from the disk and all details from the MESSAGE.IDX
file. Kill is non-reversible, so use with care.
(M)ake
Allows the creation of a new message, with no links to other messages.
This option is useful if you want to create a message for someone
without replying to an existing message.
(A)ns *
Allows you to reply to a message. The 'Subject' of the message is
automatically transferred to the reply and the 'From' name in the
original message becomes the recipient. The message is always assumed
to be from the Sysop. You are also asked whether the message is
Private, or not. (With EaziHost, only if Private messages are allowed
in the area)
If the 'Answer' configuration option has been configured, the original
message will be copied to the new message, with the configured 'Answer
prefix' at the start of each line of the original message. Replies may
then be inserted between the lines, as required, or parts of the
original message deleted. This is particularly convenient when
replying to queries and helps make replies more obvious, without the
reader having to refer back to the original message.
(E)dit *
Loads the message into the EAZIEDIT text editor (or an alternative
editor, if configured correctly) for editing. On completion, the
message is updated on screen.
(R)ead *
Toggles status of the message between 'Received' and 'Not received'.
Note : If the Sysop name option has been configured, it will
automatically mark all messages to the Sysop as having been read, as
each is read.
(S)ubj
Allows you to change the contents of the Subject field.
(F)rom
Allows you to change the name of the person the message is from. If a
new message is being created, a default name may be offered. See
'Configuring EAZMESS3' for details of specifying a default name.
(T)o
Allows you to change the name of the person the message is to.
(P)riv
Toggles the 'Private' status on and off.
With EaziHost, this only functions if the area allows Private
messages. If for any reason Private messages exist in an area where
they are not allowed - probably because the Sysop has changed the
status of the area - they may be toggled off, but not on.
(V)ali *
Allows you to change the Validation level of the person specified as
'From:' in the current message. Valid figures are 0 to 9.
(I)ncl *
Allows the person specified as 'From:' to be added to a Member List.
When selected, the Area to which the user is to be added is requested.
(N)ext (or Right Cursor key) *
Selects the next message in the index list, or the next matching
message if a search filter has been specified. See '(O)rigin, '(D)est'
and '(H)ead' for details of searching.
(B)ack (or Left Cursor key) *
Selects the previous message in the index list. If message 'filtering'
is in use with '(H)ead', '(O)rig' or '(D)est' options, it will find
the previous matching message, if any.
(G)oto
Allows you to specify the number of the message you wish to view. You
may go to any message, either forwards or backwards. '(G)oto' with an
absurdly high number will always find the latest message. Note that
the total number of messages is always displayed at the top right of
the screen.
Note: The number is the physical number of the message in the list of
messages, not the original message number (shown in square brackets on
the top line of the message header). As a result, the number for a
given message may change during the course of editing if any earlier
messages are deleted.
(J)unk
Allows you to duplicate a message to some, or all, of the users on the
current list of users in the USER.HST file. This option should be
selected when the message to be copied is the current message. The
name of each user will be offered, with the option to copy or not. The
name of the person specified in the original message is automatically
skipped, as also is the name of the Sysop, if configured.
In the case of EaziHost, names of people not validated for a message
area are also skipped and any Member Lists are also checked.
This facility is particularly useful, as EaziLink does not currently
allow you to create 'bulletins' or messages for selected groups of
users. Using this option, the same message can be sent to all the
required people. All such messages are automatically marked as
'Private'. If you want to notify everyone, the simplest way is to
create a single message to 'ALL'.
(O)rig
Allows you to select the name of a person who sent messages. Having
specified a name, use of the '(N)ext' or '(B)ack' commands will
display only messages from that person. If the entry differs from the
current header entry, the first matching message is automatically
found.
The name of the person will be highlighted in the message header to
indicate a filter is in use.
If you want to make the selection global again, use the '(C)lr' option
to clear any filter.
(D)est
Allows you to select the name of a person to whom messages have been
sent. Having specified a name, use of the '(N)ext' or '(B)ack'
commands will find only messages to that person. If the entry differs
from the current header entry, the first matching message is
automatically found.
The name of the person will be highlighted in the message header to
indicate a filter is in use.
If you want to make the selection global again, use the '(C)lr' option
to clear any filter.
(H)ead
Allows you to select the Subject of a message. Once specified, only
those Subjects containing matching text will be found by the '(N)ext'
or '(B)ack' commands.
'(H)ead is slightly different from the previous two options, in that
it will find any matching string of text within the Subject message,
whereas the others require a perfect match. The case of characters IS
significant. If the entry does not match with the current header
entry, the first matching message is automatically found.
If you want to make the selection global again, use the '(C)lr' option
to clear any filter.
NOTE:
1. '(O)rigin', '(D)est' and '(H)ead' are mutually exclusive. Only one
may be in use at a time.
2. Selecting any filter option cancels any previous filter setting.
Filters may also be removed with the '(C)lr' option.
3. Entering 'SYSOP' at any of the points in the program requiring Name
input will result in the Sysop's name being substituted, in much
the same way as happens when using EaziLink Host Mode or EaziHost.
(+) and (-)
Allow you to find the next and previous linked messages respectively.
Repeated use of one or the other will find the next/previous message
to which the current message relates.
Note: (+) and (-) are not available when filtering of messages is in
operation.
(=)
Makes a copy of the current message, having first requested the name
of the recipient. The message is marked as an 'original' message and
'Not received'. otherwise all header details are copied.
The message is preceded by a line saying 'COPY OF MESSAGE TO :',
followed by the name of the recipient of the orginal message.
(C)lr
When selected, removes any currently active filter and makes all
messages available.
(Q)uit *
Leaves EAZMESS3. If being used with EaziHost, you will be prompted to
select another area, or enter 'Q' to quit. Pressing Return will
automatically select the next area, numerically.
Return Key *
The Return key serves to move to the Next or Previous message,
depending on the direction currently in use. Pressing '(B)ack' will
select the Previous message, after which Return will continue
backwards, either until the first message is reached, or '(N)ext' is
chosen, after which it will move forwards through the messages.
When a window is opened to allow input of names etc, pressing Return
selects the offered option without changing it.
Home and End keys
The 'Home' and 'End' keys may be used to go to the First and Last
messages in an Area when in full editing mode. Their use is not
relevant when only scanning new messages.
Viewing messages that take up more than one screen
--------------------------------------------------
If a message takes up more than one screen, a message 'More? Y/N' is
displayed at the bottom. Pressing 'Y' will display the next part of
the message.
Editing Keys
------------
Certain 'special' keys may be used to edit an entry when a window
opens for entry of text, as follows.
Note: The following keystrokes only apply when entering text into
EazMess3 windows. They do not apply when using your preferred text
editor, which will use its normal keys.
Using the Home, End, Left and Right Cursor, or Backspace keys lets you
position the cursor to edit any existing entry.
Pressing any other key before using one of the above keys will delete
all existing text and position the cursor at the start of the line.
The Backspace and Del keys may be used to delete individual
characters.
Ctrl-End, or Ctrl-Y may be used to clear the text from the current
cursor position to the end of the line.
Initially, Insert mode is selected, but the 'Ins' key may be used to
change this to Overwrite mode.
Pressing Return will complete the entry.
General Notes
-------------
1. EAZMESS3 always starts at the beginning of the messages (or the
first new message initially). When you reach the end of the
messages, the program tells you there are no more and asks whether
you want to Quit.
If used with EaziLink Host mode, quitting will terminate the
program. When used with EaziHost and in 'New message' mode, the
next new area containing new messages is selected, otherwise it
allows you to change areas or Quit.
2. If no messages exist in an area, EazMess3 will ask whether you wish
to create a new message. If so, 'To' and 'Subject' details are
requested and, if relevant, whether the message is private and
automatically enter the Editor for creation of the message. In the
case of EaziHost, it will do this whenever you change to any area
with no messages.
3. If you do not have a registered copy of Eazilink (and therefore the
EaziEdit Editor, which, by default, EazMess3 expects to find in the
EAZILINK directory) and have not configured EazMess3 for your own
Editor, using the (E)dit (A)ns and (M)ake options will result in a
message saying that no editor could be found and the program will
ignore the command and wait for the next command.
The solution to this is to configure EAZMESS3 for your own editor.
Even better, register Eazilink and you get EaziEdit as well!
Configuring EAZMESS3
--------------------
EAZMESS3 needs to know the names of certain directories in order to
function and also the name and location of your text editor. It also
needs to know whether it is being used with Eazilink Host mode, or
EaziHost. This is done by creating a configuration file called
'EAZMESS3.CNF' which should be in the same directory as the
EAZMESS3.EXE program file. This may be done with any ASCII text
editor. The configuration file should contain a line of text for each
option, with the exception that the 'Answer Prefix' may be omitted if
not required.
NOTE: Entries may be in any order, but it is important that each entry
is preceded by its appropriate line identifier, followed immediately
by a colon and a space. A sample EAZMESS3.CNF file is provided.
The entries are:-
1. The Version of program being used. Required. This is used by
EazMess3 to determine a number of factors. Valid settings are:-
EL - for Eazilink
EH - for EaziHost
In either case the line should commence with 'VERSION:'. Note the
colon immediately after the line identifier
Example:
VERSION: EH
2. Name of Host Main directory. Required.
This should contain the full path of the directory, preceded by
HOSTMAIN: followed by a space before the path.
Example:
HOSTMAIN: F:\EAZIHOST\HOSTMAIN\
3. Name of the directory containing the message files (1.MSG, 2.MSG
etc). Required with EaziLink Host mode, but not with EaziHost.
This should contain the full path of the directory, preceded by
HOSTMESS: followed by a space before the path.
Note: This line may be omitted with EaziHost as it only serves a
purpose with EaziLink.
Example:
HOSTMESS: F:\EAZILINK\HOSTMESS\
4. The full pathname of the text editor to be used with EAZMESS3.
Optional, but recommended.
This should contain both the full path and the name of the text
editor, INCLUDING its filename extension - '.COM' or '.EXE' and be
preceded by the line identifier EDITOR:.
Example:
EDITOR: C:\SUNDRY\QEDIT\Q.EXE
If this entry is omitted, EazMess3 will attempt to find the
EaziEdit text editor and, failing that, will still run, but not
allow new messages to be created, or existing messages edited or
answered.
5. The Sysop's Name. Required. This is used for several purposes and
will replace SYSOP, if used when entering names. The line
identifier is SYSOP:. The case of the entry is not important as
EazMess3 automatically converts it to Upper Case.
Example:
SYSOP: DAVID FOSTER
6. 'Answer Prefix'. Optional. If an entry is made here, the original
message will be copied to the 'answer' message, with each line
containing text prefixed with the Answer Prefix.
If this entry is omitted from the CNF file, the original message
will NOT be copied to the new message.
Any combination of up to 3 characters may be used for the prefix,
such as:-
=-> or *-> or =>> or }-> or whatever you fancy!
If you specify the first two characters as '%%' and whatever you
want for the third character, EazMess3 will convert the '%%' to the
initials of the originator of the message.
Examples:
ANSWER: %%> or ANSWER: %%}
will be entered into the answer as JB> or JB} if the original
message was from Joe Bloggs, for example.
Example CNF file:-
VERSION: EL
HOSTMAIN: C:\COMMS\HOST
HOSTMESS: C:\COMMS\HOSTMESS
EDITOR: C:\SUNDRY\Q.EXE
SYSOP: DAVID FOSTER
ANSWER: =->
configures EazMess3 to work with EaziLink V3 and to look for the
MESSAGE.IDX file in the '\COMMS\HOST' directory of drive C: and the
messages in the '\COMMS\HOSTMESS' directory of drive C:. The third
line specifies that the text editor 'Q.EXE' is to be used and will be
found in the '\SUNDRY' directory of drive C: (Note that the full file
name of the editor is given, including the '.EXE' extension). The
default name to be offered for new messages will be 'DAVID FOSTER' and
original messages will be copied to the answer, prefixed with '=->'
Command Line Parameters
-----------------------
Four optional command line switches may be used, but only one at a
time.
An Area Number may follow the command, in which case EazMess3 will go
to that area immediately and display the first message. If no messages
exist, a new message may be created if required.
Example:
EAZMESS3 15
will go straight to Area 15
/A ensures that all messages and full editing facilities are available
when the program loads, instead of 'Only new messages addressed to
Sysop'. The first message area will be selected.
Example:
EAZMESS3 /A
/D enables all messages up to and including a given date to be deleted
automatically. This is particularly useful for removing large numbers
of obsolete messages.
Note: No account is taken of whether there are any replies to messages
to be deleted, but which are dated after the specified date, so it is
possible that you will have replies to messages that no longer exist.
In theory, it would be possible for EazMess3 to sift through all later
messages and remove those that are related to the ones being deleted,
but the work involved was not considered to be worth the effort for
the small number likely to be involved.
When this option is used with messages from EaziHost, all message
areas are subjected to the treatment, in turn.
The command line syntax is
EAZMESS3 /D<date>
where <date> is the date up to which all messages should be deleted.
Note that all messages for that date will also be removed.
<date> should be in the form:-
dd/mm/yy eg 21/04/89
or dd-mm-yy eg 05-04-89
or dd:mm:yy eg 11:12:89
Example:
EAZMESS3 /D21/04/89
/K is similar to the /D option and uses similar syntax, the difference
being that when /K is used, only those messages before the specified
date with BOTH 'Private' and 'Read' status are selected and each is
offered for confirmation of deletion.
This is particularly useful when the total number of messages becomes
excessive due to recipients not deleting private messages after
reading them.
The command line syntax is
EAZMESS3 /K<date>
<date> is the date before which all matching private and read messages
will be offered for deletion.
<date> should be in the form:-
dd/mm/yy eg 21/04/89
or dd-mm-yy eg 05-04-89
or dd:mm:yy eg 11:12:89
Example:
EAZMESS3 /K21/04/89
When this option is used with messages from EaziHost, all message
areas are subjected to the treatment, in turn.
History
-------
1.00a 20/05/89
- Beta version
- preliminary for as yet un-released V3 EaziLink.
- Essentially the same as the original EaziMess program, but
changed to take account of the new structure of MESSAGE.IDX
and USER.HST files.
1.00c 28/05/89
- Beta version for use with EaziLink V3
- By default, now shows only 'New Messages to Sysop initially.
When these have been read, all messages may be viewed and
edited as before. Optional override with /A command line
parameter allows all messages from the beginning.
- includes ability to follow chain of linked messages backwards
and forwards, using (+) and (-) keys.
- includes facility to change User Validation levels.
- Searches PATH directories for EAZMESS3.CNF, so program and
configuration files no longer need to be in the main EaziLink
directory.
- (B)ack movement option included, to step backwards through
messages.
- Minor changes to the way long messages are continued when
viewing.
- Return now acts as (N)ext or (B)ack, depending on which
command was used last.
3.01 08/10/89
- First release version for use with EaziLink V3.
- Added new option to menu. (M)ake a new message.
3.02 25/10/89
- Added check for existence of recipient when sending a new
message.
- No longer returns to first message when last message has been
reached.
- Fixed bug in (M)ake a new message which caused Subject not to
be requested.
- Fixed bug which caused garbage at start of new message when a
new message created. Only occurred with some editors,
including EAZIEDIT.
3.03 16/11/89
- Added new command line switch '/Kdate' to display only
messages before the specified date which are marked both
'Private' and 'Read' and offer them for deletion. This is
particularly useful as a means of removing old 'read'
messages that were not deleted by their recipient.
- Fixed bug which caused corrupted message number after editing
an existing message in certain circumstances.
- Fixed bug which caused edited messages not to be updated on
re-display.
3.50 - Pre-release Beta test version only
3.52 20/12/89 - Beta test.
- New version to work with either EaziLink V3 or EaziHost V1
- (C)opy option removed as it served no real purpose.
- Filtering made easier, with Filtered item shown in a
different colour and (C)lear option to remove any filters.
- When used with EaziHost, facilities are provided to switch
between message areas and to add users names to Member Lists.
- Obeys Private not allowed status with EaziHost and also
Member Lists.
- Performs checking of whether the recipient of newly created
messages will be able to access them in the selected area.
3.53 09/02/90 - Beta test.
- Number of message areas increased to 64 in line with
increased number available in EaziHost.
- Only Areas containing new messages are now displayed when
initially checking for new messages.
- Minor changes made to default responses to keystrokes when
initially reading 'Only new messages', so that pressing
Return repeatedly will switch from area to area without the
need to press 'Y' or 'N' on occasions.
- Default setting for prompt to create a new message has been
changed to 'N' for the above reason.
- Fixed a nasty bug which could result in a corrupted IDX file
if the (-) or (+) keys were used to try and find a link
immediately after a (K)ill.
- A new optional command line parameter has been included. A
message area number may be passed to the program so it goes
straight to that area.
3.54 10/02/90 - Beta test.
- The Left and Right cursor keys may now be used to move
backwards and forwards through the messages, in addition to
the 'B' and 'N' keys.
- Home and End keys go to first and last message when in 'full
editing' mode.
- (=) command has been included to provide an enhanced 'copy'
feature.
- Minor changes made to Junk Mail logic.
3.55 - First full release version of EazMess3 for use with EaziHost
and EaziLink Host Mode messages.
- Internal changes made to screen display library. These should
not make any visible difference to the appearance, except
that window frames are slightly different.
3.56 - Fix to small bug which caused the Total number of messages
not to be displayed in the top right hand corner.
David Foster
H.L.C. Services
High Leys
Crook
Kendal
Cumbria
LA8 8LF
END